Sistema de reservas de clientes en WordPress

Documentación CC WordPress Sistema de reservas de clientes

1. Introducción
2. Instalación y requisitos del sistema
3. Activación de la licencia
4. Panel de gestión
5. Gestión de clientes
6. Gestión de servicios
7. Sistema de reservas
8. Calendario de reservas
9. Bloqueo temporal
10. Sistema de basculación
11. Estadísticas e informes
12. Importar clientes desde CSV
13. Formulario de reserva en el anverso
14. Personalización de la apariencia
15. Notificaciones por correo electrónico
16. Configuración avanzada
17. Resolución de problemas
18. PREGUNTAS FRECUENTES

1. introducción

• Calendario de reservas avanzado con integración de FullCalendar 6.1
• Completa gestión de clientes con historial de visitas
• Sistema de servicios con precios, descuentos y duración
• Bloqueo de franjas horarias (vacaciones, descansos)
• Sistema de propinas para cada reserva
• Estadísticas e informes financieros detallados
• Importar clientes desde archivos CSV
• Formulario de reserva para clientes en la portada del sitio web
• Calendario público con las fechas de mayor actividad
• Notificaciones automáticas por correo electrónico
• Colores de interfaz personalizados
• Multidivisa y ajustes flexibles
• Sistema de gestión de licencias

2. Instalación y requisitos del sistema

• WordPress 5.0 o superior
• PHP 7.4 o posterior
• Base de datos MySQL 5.6 o superior
• Permiso para crear Custom Post Types
• Posibilidad de enviar correos electrónicos a través de WordPress (opcional)

1. Descargue el archivo ZIP del plug-in desde el sitio web oficial códigos.cocos
2. Acceda al panel de administración de WordPress
3. Vaya a: Plugins → Añadir nuevo → Subir plugin al servidor.
4. Seleccione el archivo ZIP descargado y haga clic en "Instalar ahora".
5. Una vez finalizada la instalación, haga clic en "Activar plug-in".
6. El plugin registrará automáticamente los Custom Post Types (reservas, clientes, servicios)
7. Se creará un nuevo menú "Reservas" en el panel de control de WordPress
8. Vaya a Reservas → Configuración para configurar el complemento.

3. activación de la licencia

1. Tras la instalación, ve a Reservas → Configuración.
2. Seleccione la pestaña "Licencia
3. Introduzca la clave de licencia recibida tras la compra
4. Haga clic en "Activar licencia".
5. Tras la activación, aparecerá un mensaje de confirmación.
6. Se desbloquearán todas las funciones del complemento

4 Panel de gestión

• Panel principal - resumen de estadísticas clave y próximas reservas
• Calendario - calendario interactivo de todas las reservas y bloques horarios
• Reservas - lista filtrable y editable de todas las reservas
• Clientes - gestión de la cartera de clientes con historial de visitas
• Servicios - catálogo de servicios con precios y descuentos
• Estadísticas - informes y análisis financieros detallados
• Importaciones de clientes - Importación masiva de datos de clientes desde archivos CSV
• Ajustes - configuración de todas las funciones del plug-in

• Ajustes - configuración de horas de funcionamiento, divisas, colores y notificaciones
• Documentación - enlace al manual completo en línea
• Licencia - gestión de licencias de plug-ins
• Plug-ins - información sobre otros productos COCOS
• Ayuda - acceso a la asistencia técnica

5. gestión de clientes

• Nombre - el nombre completo del cliente (que aparece como título de la entrada)
• Número de teléfono - contacto telefónico (sirve para detectar duplicados)
• Dirección de correo electrónico - utilizado para las notificaciones (opcional)
• Notas - información adicional sobre el cliente (preferencias, alergias, comentarios)
• Historial de visitas - lista generada automáticamente de todas las reservas

1. Vaya a Reservas → Clientes → Añadir cliente.
2. Introduzca su nombre en el campo del título
3. Rellene sus datos de contacto (el teléfono es obligatorio)
4. Añada notas si es necesario
5. Haga clic en "Publicar".

• Al editar un cliente, se muestra una tabla con todas sus reservas
• Información sobre la fecha, hora, servicio y estado de cada visita
• Indicación de si la visita ha sido pagada
• Enlace directo para editar cualquier reserva

6 Gestión de los servicios

• Nombre del servicio - en formularios y facturas
• Descripción - descripción detallada del servicio (opcional)
• Duración - en minutos (por ejemplo, 30, 45, 60, 90, 120)
• Precio - el precio básico del servicio en la moneda elegida
• Tipo de descuento - porcentaje (%) o importe fijo
• Valor del descuento - cuantía del descuento según el tipo

1. Vaya a Reservas → Servicios → Añadir servicio.
2. Introduzca el nombre del servicio en el campo título
3. Si lo desea, añada una descripción en el editor de contenidos
4. Rellene los datos del servicio: duración y precio
5. Establecer descuento si se ofrece
6. Haga clic en "Publicar".

• Nombre del servicio - nombre con enlace para editar
• Duración - se muestra en minutos (por ejemplo, "45 min")
• Precio - precio formateado con la divisa (por ejemplo, "80,00 PLN")
• Descuento - tipo y valor del descuento o "-" si no hay descuento
• Fecha - adición de fecha de servicio

7 Sistema de reservas

• Cliente - selección a partir de la base de datos de clientes (con motor de búsqueda AJAX)
• Servicio - selección del catálogo de servicios
• Fecha - día de la reserva
• Hora de inicio - hora de inicio del servicio
• Estado - programado / completado / cancelado
• Pagado - si la visita ha sido pagada
• Consejo - importe adicional del cliente (opcional)
• Notas - información adicional sobre reservas

1. Ir a Reservas → Reservas → Añadir una reserva.
2. Buscar y seleccionar un cliente (introducir nombre, apellidos o teléfono)
3. Seleccione un servicio de la lista desplegable
4. Fijar fecha y hora para la reserva
5. Seleccionar estado (por defecto "Programado")
6. Si lo desea, añada un consejo y notas
7. Haga clic en "Publicar".

• Cambio de estatuto - pulse en el menú desplegable de la columna "Estado".
• Marcado de los pagos - haga clic en el icono de la marca de verificación en la columna "Pagado".
• Los cambios se guardan automáticamente mediante AJAX
• Aparece una ruleta mientras se guarda

• Título - generado automáticamente: "Reserva - [Cliente] - [Servicio]".
• Cliente - nombre con enlace a la tarjeta de cliente
• Servicio - nombre del servicio con enlace a la edición
• Fecha de la visita - fecha y hora en el formato de los ajustes
• Estado - menú desplegable para cambios rápidos
• Pagado - Icono SÍ/NO con capacidad de cambio rápido

8 Calendario de reservas

• Diferentes puntos de vista - mes, semana, 3 días, un solo día
• Eventos para colorear - por estado de la reserva
• Hacer clic en una reserva - pasar a editar
• Haga clic en la fecha - creación de una nueva reserva con una fecha predefinida
• El indicador "ahora - línea roja que muestra la hora actual
• Capacidad de respuesta - adaptación automática a los dispositivos móviles
• Ubicación - traducción automática al idioma de WordPress

• Azul - reservas programadas (#007bff)
• Verde - Reservas completadas (#28a745)
• Rojo - Reservas anuladas (#dc3545)
• Gris - bloqueos de tiempo (#6c757d)

1. Ir a Reservas → Calendario
2. Seleccione su vista preferida (mes/semana/día)
3. Utilice los botones "anterior/siguiente" para navegar
4. Pulse "Hoy" para volver a la fecha actual
5. Haga clic en una reserva para editarla
6. Haga clic en una fecha libre para añadir una nueva reserva

• El calendario se ajusta automáticamente al horario laboral a partir de los ajustes
• Visualización por defecto desde la hora de inicio hasta la hora final
• La franja horaria "todo el día" está desactivada
• Todas las horas se muestran en formato de 24 horas (HH:mm)

9. bloqueo temporal

• Un tipo especial de reserva denominado "Bloqueo horario".
• No es necesario seleccionar cliente ni servicio
• Requiere una hora de inicio y fin
• Se muestra en gris en el calendario con el icono 🚫.
• No incluido en las estadísticas financieras
• Impide la creación de reservas normales en horas bloqueadas

1. Ir a Reservas → Reservas → Añadir una reserva.
2. Marca la casilla "🚫 Bloqueo horario" en la parte superior del formulario
3. Los campos Cliente y Servicio se ocultarán automáticamente
4. Fijar fecha de bloqueo
5. Especifique la hora de inicio (obligatorio)
6. Especifique la hora de finalización (necesario para los bloqueos)
7. Si lo desea, añada un título y notas (por ejemplo, "Vacaciones", "Pausa técnica").
8. Haga clic en "Publicar".

• En la lista de reservas - la columna "Cliente" muestra "🚫 Bloqueo horario".
• En el calendario - campo gris con el texto "🚫 Bloqueo horario" + título opcional.
• En la parte delantera - aparece como "Ocupado" (sin detalles)
• Intervalo de tiempo - se muestra como "fecha HH:mm - HH:mm"

10. sistema basculante

• Campo de propina en cada reserva (opcional)
• Adición automática al precio final de la reserva
• Estadísticas de propinas separadas en el cuadro de mandos
• Clasificación de los clientes más generosos
• Inclusión en informes financieros
• Seguimiento de la propina media por cliente

1. Abrir la reserva para editarla
2. Busque el campo "Propina (PLN):" en la sección de pagos
3. Introduzca el importe de la propina (por ejemplo, 10,00)
4. La propina se añadirá automáticamente al precio final
5. Guardar una reserva

Precio final = (Precio del servicio - Descuento) + Propina
Ejemplo:
Servicio: 100 PLN
Descuento 10%: -10 PLN
Propina: 15 PLN
Precio final: 105 PLN

• Cuadro de mandos - azulejo con el total de propinas del mes en curso
• Los clientes más generosos - clasificación con propinas totales y medias
• Estadísticas - informes detallados de propinas por periodo
• Ganancias - propinas incluidas en los informes de ingresos

11 Estadísticas e informes

• Ganancias de este mes - ingresos totales por visitas realizadas
• Número de reservas - todas las reservas del mes en curso
• Pagado - total de reservas pagadas
• A pagar - total reservas impagadas
• Consejos de este mes - importe de la propina por separado

• Formulario de filtrado - selección del intervalo de fechas para el análisis
• Comparación con el periodo anterior - variación porcentual de ingresos y reservas
• Tasa de anulación - porcentaje de anulaciones
• Previsión de ingresos - ingresos previstos por visitas programadas
• Llenar hoy - porcentaje de franjas horarias ocupadas
• Tiempo medio entre visitas - análisis de los índices de devolución de clientes

• Visualización de los ingresos de cada mes del año en curso
• División en pagados (verde) y por pagar (amarillo)
• Gráfico de barras interactivo con valores
• Nombres de mes abreviados para una mejor legibilidad

• Gráfico de la popularidad de cada hora del día (0-23)
• Identificación de máximos y mínimos de ocupación
• Ayuda para optimizar el horario laboral
• Visualización en forma de gráfico de barras

• Comparación de los ingresos de cada día (de lunes a sábado)
• Número de reservas para cada día
• Identificar los mejores y los peores días
• Asistencia en la planificación del calendario

• Clasificación de los clientes por número de anulaciones
• Porcentaje de anulaciones respecto al total de reservas
• Coloración: >30% rojo, otros gris
• Asistencia en la identificación de clientes problemáticos

• Los 10 primeros servicios por número de reservas
• Precio unitario de cada servicio
• Enlace para editar el servicio
• Numeración del 1 al 10

• Clasificación de los servicios por ingresos totales
• Número de actuaciones de cada servicio
• Precio unitario e ingresos totales
• Ayudar a identificar los servicios más rentables

• 5 próximas visitas programadas
• Fecha, cliente y servicio
• Clasificación cronológica
• Enlace para editar cualquier reserva

• Importe total perdido en rebajas
• Número de rebajas concedidas
• Análisis de la eficacia del sistema de descuentos

• Botón Exportar en la parte superior de la página de estadísticas
• Generación de un archivo CSV con todas las reservas del periodo seleccionado
• Columnas: Fecha, Hora, Cliente, Servicio, Precio, Descuento, Propina, Precio final, Estado, Pagado.
• Codificación UTF-8 con lista de materiales para caracteres polacos
• Nombre del fichero: statistics-reservations-[data].csv

12. Importación de clientes desde CSV

• Separador - coma (,)
• Codificación - UTF-8
• Primera línea - encabezamientos de columna (se omitirán)
• Tamaño máximo - 2MB

1. Nombre - necesario
2. Nombre - necesario
3. Teléfono - obligatorio (sirve para detectar duplicados)
4. Correo electrónico - opcional
5. Notas - opcional

Nombre,Apellidos,Teléfono,Email,Notas
Jan,Kowalski,+48500100200,[email protected],Stały cliente
Anna,Nowak,+48600200300,[email protected],Preferuje tardes
Piotr,Wiśniewski,+48700300400,,

1. Ir a Reservas → Importar clientes
2. Lea las instrucciones y los requisitos
3. Prepare el archivo CSV según el formato
4. Haga clic en "Seleccionar archivo CSV" y seleccione el archivo
5. Haga clic en "Importar clientes".
6. Esperar a que finalice la importación
7. Leer el informe de resultados

• Comprobar el tipo de archivo - sólo text/csv y text/plain
• Validación de datos - los campos obligatorios no deben estar en blanco
• Detección de duplicados - a partir de un número de teléfono
• Saneamiento de datos - limpieza de todos los valores de entrada

• Importado - número de clientes añadidos con éxito
• Omitido - número de registros rechazados
• Detalles del error - un máximo de los 10 primeros errores
• Motivos de la omisión - datos que faltan, duplicados, error de registro

• Haga una copia de seguridad de la base de datos antes de realizar importaciones importantes
• Probar la importación en una pequeña muestra de datos (5-10 registros)
• Garantizar la coherencia del formato de los números de teléfono
• Compruebe la codificación del archivo (debe ser UTF-8)
• Eliminar filas vacías de un archivo CSV
• Las importaciones grandes (>100 registros) pueden tardar varios minutos

13. formulario de reserva en el anverso

• Nombre - obligatorio, texto
• Nombre - obligatorio, texto
• Número de teléfono - obligatorio, campo tel con marcador de posición
• Correo electrónico - opcional, validación de correo electrónico
• Seleccionar servicio - obligatorio, lista desplegable con precios
• Fecha de la visita - obligatorio, campo de fecha (mín: hoy)
• Hora de la visita - necesario, seleccionar con horario de trabajo

• Nonce WordPress - Protección CSRF
• Validación en el servidor - comprobación de todos los campos
• Comprobar la disponibilidad - si la fecha ya está ocupada
• Validación por intervalos - si la hora coincide con los intervalos establecidos
• Detección de reservas solapadas - teniendo en cuenta la duración de los servicios

1. Crea un nuevo sitio de WordPress (Sitios → Añadir nuevo).
2. Llámelo, por ejemplo, "Reserva en línea".
3. En el editor, pegue el shortcode: [cc_reservation_form]
4. Si lo desea, puede cambiar el título: [cc_reservation_form title="Concierte una cita"].
5. Publicar la página
6. Copie el enlace y añádalo al menú del sitio web

1. El cliente rellena el formulario
2. Después de hacer clic en "Reservar una cita", se produce la validación
3. El sistema comprueba si el cliente ya existe (por número de teléfono)
4. Si no, crea automáticamente un nuevo cliente
5. Se comprueba la disponibilidad de la fecha seleccionada
6. Se crea una nueva reserva con el estado "Programada".
7. Se envían notificaciones por correo electrónico (si están activadas)
8. El cliente ve el mensaje de confirmación

• Éxito - "¡La reserva ha sido aceptada! Se ha enviado la confirmación a su correo electrónico".
• Fecha - "Esta fecha ya está ocupada. Por favor, seleccione otra fecha".
• Error de datos - "Rellene todos los campos obligatorios".
• Error de grabación - "Error al guardar la reserva. Inténtelo de nuevo".

• Muestra todas las citas ocupadas como "Ocupado".
• No muestra los detalles de la reserva (privacidad)
• Las visitas canceladas se ocultan
• Localización automática (idioma de WordPress)
• Diseño adaptable
• Vistas: mes, semana, día

14. personalización de la apariencia

• Color principal - el color principal de la interfaz
• Paletas predefinidas - 8 combinaciones de colores predefinidas
• Vista en directo - visualización inmediata de los cambios
• Persianas automáticas - el sistema genera color hover (-30 de brillo)

• Formulario de reserva - botones, encabezados, foco de entrada
• Calendario - botones de navegación, fecha de hoy, visualización de la hora
• Botones - background, hover, active, focus
• Entradas - borde en el foco, borde izquierdo de los campos obligatorios
• Titulares - borde inferior (border-bottom)

1. Vaya a Reservas → Ajustes
2. Busque la sección "Aspecto frontal
3. Haga clic en el cuadro de color o seleccione en la paleta
4. Utilice los botones "Selección rápida de colores" para las paletas predefinidas
5. Compruebe la vista previa en directo (botón de ejemplo, encabezado, entrada)
6. Guardar la configuración

• Botón de ejemplo - color de fondo, hover más oscuro
• Ejemplo de titular - borde inferior en color principal
• Campo de entrada - marco de enfoque en color principal
• Interactividad - pasar el ratón sobre el botón, centrarse en la entrada

// función adjust_color_brightness en Plugin.php
public static function ajustar_brillo_color($hex, 1TP4Pasos) {
    // Convertir HEX a RGB
    // Sumar/restar $steps a cada componente
    // Conversión de nuevo a HEX
    // Devuelve el color más oscuro/más brillante
}

• Los estilos se adaptan automáticamente a las preferencias del usuario
• Utilizando la consulta de medios: @media (prefiere esquema de color: oscuro)
• El color guía funciona tanto en modo claro como oscuro

15. notificaciones por correo electrónico

• Confirmación para el cliente - correo electrónico después de la reserva con éxito de la parte delantera
• Notificación al administrador - nueva información sobre reservas
• Envío automático - sólo para reservas anticipadas
• Reservas manuales - sin notificaciones automáticas

Asunto: Confirmación de reserva - [Nombre del sitio].
Hola [Nombre del cliente].
Su reserva ha sido confirmada.
Detalles:

Servicio: [Nombre del servicio].
Fecha: [Fecha de reserva].
Hora: [Hora].

¡Nos vemos allí!
[Nombre del sitio]

Asunto: Nueva reserva - [Nombre del cliente].
[El mismo contenido que para el cliente].

1. Vaya a Reservas → Ajustes
2. Busque la sección "Notificaciones
3. Marque "Enviar notificaciones de reservas por correo electrónico".
4. Introduzca el correo electrónico del administrador (por defecto: admin_email WordPress)
5. Guardar la configuración

• WordPress debe tener configurada la función wp_mail()
• El servidor debe poder enviar correos electrónicos
• El cliente debe introducir una dirección de correo electrónico válida en el formulario
• Para una entrega más fiable, recomendamos un plugin SMTP (por ejemplo WP Mail SMTP).

• El correo electrónico no llega - comprobar spam, configurar SMTP
• Remitente equivocado - WordPress utiliza [email protected]
• No hay correo electrónico del cliente - el campo de correo electrónico es opcional, asegúrese de rellenarlo
• Función desactivada - marque la casilla de verificación en los ajustes de notificación

16. configuración avanzada

• Moneda - PLN, EUR, USD, GBP
• Posición en divisas - antes o después de la cuota
• Formato de fecha - p. ej. d.m.Y (31.12.2025), Y-m-d (2025-12-31)
• Formato de hora - H:i (24h) o h:i A (12h con AM/PM)

• Hora de inicio - inicio de la jornada laboral (por defecto: 08:00)
• Hora de cierre - fin de la jornada laboral (por defecto: 18:00)
• Intervalo de reserva - cada cuántos minutos es posible reservar (por ejemplo, 15, 30, 45, 60)

• Color principal - el color principal de la interfaz (para más detalles, véase el capítulo 14)
• Paletas predefinidas - 8 combinaciones de colores predefinidas
• Vista en directo - visualización interactiva de los cambios

• Reservas desde la parte delantera - formulario de activación/desactivación en la página
• Vista del calendario - mes / semana / día

• Notificaciones por correo electrónico - correos electrónicos automáticos tras la reserva
• Correo electrónico del administrador - dirección para las notificaciones (por defecto admin_email WP)
• Notificaciones por SMS - función en preparación (no activa)

• Habilitar la adición de datos de muestra - datos automáticos al activarse
• 3 clientes de muestra
• 4 ejemplos de servicios
• 5 muestras de reservas (futuras e históricas)

• Una tabla con todos los shortcodes mostrados en los ajustes
• Descripción de cada shortcode y sus parámetros
• Ejemplos de uso
• Botón "Copiar" al portapapeles para cada shortcode

// Los ajustes son procesados por:
admin_post_cc_wp_cr_save_settings
// Y guardados en las opciones de WordPress:
cc_wp_cr_options (array de todos los ajustes)
// Acceso a los ajustes en código:
$plugin->get_option('currency'); // opción única
$plugin->get_all_options(); // todas las opciones

17. Resolución de problemas

1. Comprueba si tienes una licencia activa (Ajustes → Licencia).
2. Asegúrese de haber iniciado sesión como administrador
3. Comprobar los permisos de escritura de la base de datos
4. Desactivar la caché de WordPress y los plug-ins de caché
5. Compruebe los registros de errores de PHP (WP_DEBUG = true)
6. Garantizar que el nonce pasa la validación

1. Compruebe si hay reservas en el sistema
2. Garantizar que las reservas tengan fecha y hora fijas
3. Compruebe si hay errores de JavaScript en la consola del navegador
4. Compruebe que FullCalendar se ha cargado (compruebe las fuentes de la página)
5. Borrar la caché del navegador y la caché de plug-ins
6. Compruebe que el endpoint AJAX funciona (admin-ajax.php)

1. Asegúrate de que la función está activada en los ajustes
2. Compruebe que el shortcode se ha pegado correctamente
3. Compruebe los errores de JavaScript en la consola del navegador
4. Asegúrese de que el script reservation-form-frontend.js se ha cargado
5. Compruebe que el nonce se ha generado correctamente
6. Desactive otros plug-ins para la detección de conflictos

1. Comprueba si la función está activada en los ajustes
2. Asegúrese de que el cliente ha introducido un correo electrónico en el formulario
3. Compruebe su carpeta de correo no deseado
4. Verificar la configuración de wp_mail() (envío de prueba)
5. Instale un complemento SMTP (por ejemplo, WP Mail SMTP)
6. Compruebe los registros del servidor de correo

1. Comprobar formato de archivo (separador: coma, codificación: UTF-8)
2. Asegúrese de que la primera línea es la cabecera
3. Compruebe que se han rellenado todas las columnas obligatorias
4. Comprobar la exactitud de los números de teléfono
5. Eliminar líneas vacías del fichero
6. Prueba en una muestra pequeña (5-10 registros)

1. Compruebe que las reservas tienen el estado correcto ("Completado" para las estadísticas)
2. Garantizar que los servicios tienen precios asignados
3. Verificar las fechas de reserva (si coinciden con el periodo filtrado)
4. Comprobar que los descuentos se calculan correctamente
5. Reconstruir la caché de estadísticas (desactivar/activar el complemento)

1. Asegúrese de que la casilla "Bloqueo horario" está marcada
2. Compruebe que se indica la hora de cierre
3. Compruebe que los horarios no se solapan con otras reservas
4. Compruebe que el JavaScript que permite ocultar campos funciona
5. Borrar la caché del navegador

1. Asegúrate de hacer clic en "Guardar configuración".
2. Borrar la caché de WordPress y los plug-ins de caché
3. Borrar la caché del navegador (Ctrl+F5 o Cmd+Mayús+R)
4. Comprobar que se generan estilos en línea en el código fuente
5. Compruebe que está utilizando la última versión del plug-in

18. FAQS